home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr05 / ew120.zip / FILES1.ZIP / KILLDLL.DOC < prev    next >
Text File  |  1993-05-02  |  3KB  |  90 lines
  1.  
  2.  
  3.  
  4.                 The DLL Killer
  5.  
  6.  
  7.             A utility for Windows programmers
  8.  
  9.                  by
  10.  
  11.               Patrick Philippot, France
  12.  
  13.              CIS : 72561, 3532
  14.  
  15.  
  16.                Public Domain Software
  17.  
  18.  
  19.  
  20.      WARNING!! WARNING!! WARNING!! WARNING!! WARNING!! WARNING!!
  21.  
  22.          This program is definitively not intended for end-users. It's a
  23.     debugging aid that should be used only by programmers and technical
  24.     support people.
  25.  
  26.  
  27.      KillDLL is a small utility that I have written for my own needs
  28.     and that may be useful to you. Here it is, free of charge and for use
  29.     at your own risk.
  30.  
  31.  
  32.      Why a DLL killer?
  33.  
  34.      While writing the E! for Windows API (E! for Windows is a text
  35.     editor that we recently released as a shareware), I frequently found
  36.     myself with a main program (E!) that had hung because of a bug in the
  37.     extension DLL I was currently debugging.
  38.  
  39.      So, the program terminated abnormally and could not unload all
  40.     the other extension DLLs it had loaded. The next time I wanted to run
  41.     E!, all these DLLs were still there and their initialization code was
  42.     not executed (it is executed only once when the DLL are first
  43.     loaded). This is of course a rather unsafe situation because E!
  44.     extension DLLs very often need to communicate with the running copy
  45.     of E! when they are installed. The only way to return to a safe
  46.     situation was to exit Windows and to launch it again.
  47.  
  48.          I think this or similar situations can happen to you. That's why
  49.     I decided to make this small program available.
  50.  
  51.      KillDLL allows you to unload an orphaned DLL without having to
  52.     exit Windows. An orphaned DLL is a DLL that has a non-zero usage count
  53.     but that is not likely to be unloaded by a call to FreeLibrary because
  54.     no further application is aware of it.
  55.  
  56.      Run KillDLL. It will show you a small dialog box where all the
  57.     currently loaded DLLs are listed. Select the DLL you want to unload
  58.     and click on the "Kill" button. A warning message will be issued.
  59.     Click OK if you maintain your decision. The DLL list will be
  60.     automatically refreshed.
  61.  
  62.          You can unload ANY DLL in the system. So, be sure of what you're
  63.     doing. You can even unload KERNEL! The result will be an immediate
  64.     exit from Windows.
  65.  
  66.      KillDLL uses the FreeLibrary API to unload the DLL. So, the DLL
  67.     exit procedure will always be executed.
  68.  
  69.      KillDLL uses undocumented information to be able to separate
  70.     DLLs from other modules. Thanks to "Undocumented Windows", the famous
  71.     book written by Schulman, Maxey and Pietrek. Be aware that this
  72.     program may not work with future versions of Windows.
  73.  
  74.      KillDLL is a Public Domain software and nobody is allowed to
  75.     charge any amount of money for distributing KillDLL.
  76.  
  77.      If you want any information about our E! editor for Windows
  78.     please contact me on Compuserve [72561,3532] or fax your request to:
  79.  
  80.      Juergen Egeling Computer
  81.      Werderstr. 41, 7500 Karlsruhe, Germany.
  82.      Tel: (0721) 373832
  83.      Fax: (0721) 373842
  84.  
  85.  
  86.     Have fun!
  87.  
  88.     Patrick Philippot
  89.     15/12/92
  90.